home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 8: LINUX Games / Linux Cubed Series 8 - LINUX Games.iso / games / x11 / video / xblast-2.0 < prev    next >
Text File  |  1996-11-17  |  13KB  |  476 lines
  1. Program XBLAST V2.0 
  2. 1993-1996 (C) by Oliver Vogel (e-mail: vogel@ikp.uni-koeln.de)
  3. May 6th, 1996
  4. started August 1993
  5.  
  6. File: README
  7.  
  8.  
  9. ICENSE
  10.  
  11. This program is free software; you can redistribute it and/or modify
  12. it under the terms of the GNU General Public Licenses as published
  13. by the Free Software Foundation; either version 2; or (at your option)
  14. any later version
  15.  
  16. This program is distributed in the hope that it will be entertaining,
  17. but WITHOUT ANY WARRANTY; without even the implied warranty of
  18. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  19. General Public License for more details.
  20.  
  21. You should have received a copy of the GNU General Public License along
  22. with this program; if not, write to the Free Software Foundation, Inc.
  23. 675 Mass Ave, Cambridge, MA 02139, USA.
  24.  
  25. AUTHORS
  26.  
  27. Oliver Vogel (main author)
  28. vogel@ikp.uni-koeln.de
  29.  
  30. Garth Denley (coauthor)
  31. g0denley@teaching...
  32.  
  33. INTRO
  34.  
  35. XBlast is a multi-player arcade game for X11R5/R6. The game can be played
  36. with at least two players and up to four players. It was inspired by
  37. the video/computer game Bomberman(Dynablaster), which was to my
  38. knowledge first programmed for NEC's PC Engine/Turbo Grafx. Other
  39. (commercial) versions of the original game exist for IBM-PC, Atari ST,
  40. Amiga, NES, GameBoy and Super NES.
  41.  
  42.  
  43. FEATURES
  44.  o  2 to 4 players
  45.  o  1 or 2 players per X-Server
  46.  o  52 different Levels
  47.  o  X11R5 or X11R6
  48.  o  Full color and monochrome support
  49.  o  Resolution: 960x688
  50.  o  monochrome XBlast needs ~200 kB (~280 kB with Backing Store) 
  51.     of X-Server memory. Color XBlast needs about 8 times the 
  52.     memory on an 8-bit display, however.
  53.  o  Compact binary ~350 kB with shared libraries ~600kB with static
  54.     libraries.
  55.  o  Small CPU usage 
  56.  
  57.  
  58. HINT
  59.  
  60. For descriptions of command-line arguments read the man-page or
  61. type xblast -?. If you start xblast without any option an
  62. interactive setup of game parameters is started.
  63.  
  64. FTP SITE
  65.  
  66. The current version of xblast will be uploaded to the FTP server
  67. ftp.x.org in the directory /contrib/games/multi_player. XBlast 2.0 or
  68. higher versions will also be uploaded to sunsite.unc.edu.
  69.  
  70. FILES
  71.  
  72. The XBlast package contains the following files:
  73.  
  74.   o  COPYING        - GNU Public License
  75.   o  INSTALL            - how to install xblast
  76.   o  Imakefile          - imakefile for xmkmf
  77.   o  Levels.HOW         - instruction how to create your own levels 
  78.   o  README             - this file
  79.   o  XBlast.ad          - application resource file
  80.   o  Xresources         - a sample Xresources file
  81.   o  xblast.man         - xblast man-page
  82.   o  block.c        \
  83.   o  block.h        |- xblast source files
  84.   o  const.h        |
  85.   o  data.c        |
  86.   o  data.h        |
  87.   o  defaults.h        |
  88.   o  event.c        |
  89.   o  event.h        |
  90.   o  expl.c        |
  91.   o  expl.h        |
  92.   o  func.c        |
  93.   o  func.h        |
  94.   o  graphics.c        |
  95.   o  graphics.h        |
  96.   o  include.h        |
  97.   o  info.c        |
  98.   o  info.h        |
  99.   o  intro.c        |
  100.   o  intro.h        |
  101.   o  introdat.h        |
  102.   o  main.c        |
  103.   o  main.h        |
  104.   o  maze.c        |
  105.   o  maze.h        |
  106.   o  mytypes.h        |
  107.   o  patchlev.h        |
  108.   o  resource.h        |
  109.   o  score.c        |
  110.   o  score.h        |
  111.   o  setup.c        |
  112.   o  setup.h        |
  113.   o  shrink.c        |
  114.   o  shrink.h        |
  115.   o  shrinkdat.h    |
  116.   o  sprite.c        |
  117.   o  sprite.h        |
  118.   o  status.c        |
  119.   o  status.h        /
  120.  
  121.   o  bitmap/        - subdirectory for all bitmap files
  122.   o  level/             - subdirectory for all level data files
  123.  
  124.   o  tcl/               - xblast launcher tcl/tk script
  125.   o  etc/               - useful script for level creators
  126.  
  127.  
  128. GAMEPLAY
  129.  
  130. The idea of the game is quite simple "There can be only one ...".  So
  131. the aim is to blast away all the other players. You can set the number
  132. of victorious matches required to win the total game with the `-v`
  133. option.  Use your bombs to blast away the other players and certain
  134. blocks (e.g. the ?-Blocks in the 1st level). Under some of these
  135. blocks are extras, which increase the number of bombs you can drop
  136. simultaneously (the bomb symbol) or increase the range of your bombs
  137. (the flame symbol). In higher levels there are other extras like the
  138. skull-symbol which infects the player with a random illness. These
  139. illnesses heal after some time, but while infected the player can also
  140. infect other players. Another extra is the star symbol which makes the
  141. player invincible for some time.
  142.  
  143.  
  144. CONTROL 
  145.  
  146. The number keys 2,4,6,8 on the number pad are used to control the
  147. first player of each X-server. If you press one of these keys the
  148. player starts walking in this direction and stops only if he/she hits
  149. an obstacle or the stop key 5 is pressed. In the latter case the
  150. player stops in the middle of the next field. Furthermore you can
  151. change the walking direction by using the direction keys.  If the key
  152. 0 is pressed a bomb is dropped in the middle of the player's current
  153. field. Be careful not to drop the bomb to early, as you can block your
  154. own way with it (bombs are always blocking the way).  If you have
  155. found a remote control (in "Running Man") press + to ignite your
  156. bombs.
  157.  
  158. The second player of the X-Server uses the keys T, F, H, B/V to walk,
  159. SPACE to bomb, G to stop and TAB for remote control. If only one
  160. player uses an X-Server both controls will work for him.
  161.  
  162.  
  163. TESTED PLATFORMS
  164.  
  165. I have tested the current version program on the following computers
  166.  
  167.   o i486DX266-PC with Linux 1.2.13
  168.   o DEC 5000/240 with Ultrix 4.2A
  169.   o HP 9000-730S with HP-UX 9.01
  170.   o Motorola MVME-147SA with LynxOS 2.1
  171.   o Sun Sparc 2 with SunOS 4.1.3
  172.   o Force Sparc 2CE with NetBSD 1.1
  173.  
  174. Furthermore older versions were compiled by other persons on 
  175. the following machines
  176.  
  177.   o DEC Alpha with OSF/1 Motif
  178.   o SGI workstation IRIX Release 4.0.5 System V
  179.   o IBM RS/6000 with AIX 3.2.4
  180.   o Sparc 10/41 with Solaris 2.3 (using gcc)
  181.   o PC with SCO Open Desktop 3.0 (using gcc)
  182.   o Sun Sparc Classic with SunOS 4.1.3c
  183.   o HP 9000-710 with HP-UX 9.01
  184.   o PC 486DX2 with NetBSD 0.9
  185.  
  186.  
  187. I hope it will run on all other computers with X11R5/R6.  If you managed
  188. to build the game on any other machine, please send me a short notice
  189. to the E-Mail adress below.
  190.  
  191. CREATING YOUR OWN LEVELS
  192.  
  193. An instruction to create your own levels is given in the file
  194. Levels.HOW
  195.  
  196. XBLAST SETUP
  197.  
  198. You have three possibilities when starting XBlast:
  199.  
  200.  o no command-line options and configuration via text interface
  201.  o configuration via command-line options
  202.  o tk/tcl script for a setup with a X Interface
  203.  
  204. In order to use the tcl/tk script, first take a look at the README file 
  205. in the subdirectory tcl/.
  206.  
  207.  
  208. WHATS NEW IN V2.0
  209.  
  210.  o Support for color graphics
  211.  
  212.  o 22 new levels most of them from Garth Denley
  213.  
  214.  o New Tcl/Tk based launcher for XBlast. Now allows loading and 
  215.    saving setups.
  216.  
  217.  o Revised command-line interface, with easier player and display
  218.    setup.
  219.  
  220.  o Improved (and more stable) interactive setup.
  221.  
  222.  o Support for Xresources. Setup individual colors and in-game messages
  223.    for your player using xrdb. (G.D and me)
  224.  
  225.  o Several different setups can now be saved. The setup file
  226.    is now an Xresource file, and should be more readable
  227.    than the old one. 
  228.  
  229.  o intro screen for each level (G.D. and me)
  230.   - just read what awaits you in the next level.
  231.  
  232.  o new extras:
  233.   - Air pump, blow bombs out of your way (G.D.)
  234.   - Junkie Virus, once you get , you will need it (G.D.)
  235.   - Napalm bombs, Garth's devasting area effect bombs (G.D.)
  236.   - Firecracker, another one of Garth's devious new bombs. (G.D).
  237.  
  238.  o two further sicknesses
  239.   - teleporter sickness
  240.   - reverse walking sickness (by Xavier Caron)
  241.  
  242.  o new (optional) bomb behaviors (G.D.)
  243.   - snooker bombs
  244.   - bomb launching walls
  245.   - bomb bounce off walls, others bombs or players in some levels 
  246.   - bomb detonate at walls, others bombs or players in some levels 
  247.  
  248.  o other new features
  249.   - random player start positions (G.D.)
  250.  
  251.  o Each level and each bitmaps now has its own include file,
  252.    (Bitmaps in xbm format) for easier editing and sharing
  253.    levels and bitmaps.
  254.  
  255.  o Tcl scripts to add/remove levels/bitmaps files to the source code.
  256.  
  257.  
  258. WHATS NEW IN V1.2
  259.  
  260.  o  21 new levels, of which 19 are contribution from xblasters
  261.     all over the world. (See also CREDITS below).
  262.  
  263.  o  a new extra type:
  264.    - teleporter extra (by Patrick Durish )
  265.  
  266.  o several new features:
  267.    - short fuse bomb (by Mike Schneider)
  268.    - haunted bombs (by Garth Denley)
  269.  
  270.  o two new sickness types
  271.    - malfunction sickness
  272.    - invisible sickness
  273.  
  274.  o new command-line switches
  275.    - "-nokick" to disable kick bomb extra\
  276.    - "-s[howlevels]" to show all levels in the game
  277.    - "-u[se]" to give a list of levels to play
  278.    - "-f[rames]" to set the number of frames per second
  279.  
  280.  o bugfix for Solaris
  281.    - xblast now calls XtToolkitInitialize()
  282.  
  283. WHATS NEW IN V1.1
  284.  
  285.  o  Filenames are changed to less than 15 char
  286.     (Required for X11R6 contrib)
  287.  
  288.  o  TWO new extra types:
  289.    - kicking bombs
  290.    - blast ALL bombs
  291.  
  292.  o  new shrinking feature for many levels
  293.    - the level starts shrinking after half the game time
  294.    - shrinking is more moderate than in Shrinking World
  295.  
  296.  o  extra conservation
  297.    - when a player dies, his extras are distributed
  298.      on the map
  299.  
  300.  o  bomb malfunction
  301.    - sometimes a bomb will take longer to explode.
  302.  
  303.  o  bugfix of a timing bug, which appeared under Solaris 
  304.     (this bugs makes the players run uncontrollable).
  305.  
  306.  
  307. THE FUTURE
  308.  
  309. The following things are planned for the future version
  310. (with absolutely NO WARRANTY that they will come):
  311.  
  312.  o  Support for 5 Players
  313.  o  Control keys defined by Xresources
  314.  o  Team modes : 2 on 2, all on 1, 4x2 player mode.
  315.  o  An improved Tcl/Tk-Setup with game statistics and level selection.
  316.   
  317.  
  318. Things which are planned, but will take some time 
  319.  
  320.  o  Sound Support for Netaudio and/or Voxware
  321.  o  real client/server model.
  322.  o  a better and more detailed guide how to build your own levels
  323.  o  a tcl/tk based level editor.
  324.  o  a tck/tk based Xresource setup
  325.  o  more levels with new extras, graphics and monsters?
  326.  
  327.  
  328. BUGS
  329.  
  330. Known are the following:
  331.  
  332.  o  "make depend" makes troubles on some computers. There
  333.     seem to be too many files opened. Most of the time
  334.     it does not get all dependencies. But I also encountered
  335.     scrambled bitmap files on our SunOS machine. If it
  336.     does not work correctly, just use "xmkmf" instead
  337.     of "xmkmf -a".
  338.  
  339.  o  If the program doesn't react to any key press, move the mouse pointer
  340.     outside the window and then inside again.
  341.  
  342.  o  XBlast needs a quite fast XServer for color graphics.
  343.     A rough estimate is about 100000 XStones. Linux PCs
  344.     with an accelerated card work or modern color X terminals
  345.     work as well.
  346.  
  347.  o  With certain X-Servers the control via number-pad doesn't work.
  348.     Try Num-Lock or  change your Xmodmap (This should be
  349.     fixed since XBlast 1.1). 
  350.  
  351. If you find any other bugs, please report them to
  352.  
  353. E-MAIL: vogel@ikp.uni-koeln.de
  354.  
  355.  
  356. CREDITS
  357.  
  358. CONTRIBUTORS
  359.  
  360. Xavier Caron (x-caron@es2.fr)
  361.  
  362.  o New Illness:
  363.    -  new reverse walking illness
  364.  
  365.  o Bugfix:
  366.    -  bombs falling into walls (Gravitation)
  367.  
  368. Chris Doherty (cpdohert@teaching.cs.adelaide.edu.au)
  369.  
  370.  o New Features:
  371.    -  Fungus bombs
  372.    -  Three bombs
  373.    -  Grenade
  374.    -  Triangle bombs
  375.    -  Destruction bombs
  376.    -  Renovation bombs
  377.  
  378.  O New Levels:
  379.    -  Spindizzy (together with Garth Denley=
  380.  
  381. Patrick Durish (dri@eup.siemens-albis.ch)
  382.  
  383.  o New Features:
  384.    - Teleporter Extra
  385.  
  386.  o New Levels:
  387.    - Mr. Beam
  388.  
  389. Rob Hite (hite@tellabs.com)
  390.  
  391.  o New Levels:
  392.   - Indiana Jones
  393.   - Hallways
  394.  
  395. Christophe Kalt and Pierre Ramet 
  396. (kalt@hugo.int-evry.fr,ramet@labri.u-bordeaux.fr)
  397.  
  398.   o New Levels:
  399.     - Shrinking Arena
  400.  
  401. Joachim Kaltz (kaltz@essi.fr):
  402.  
  403.  o New Levels:
  404.    - Nowhere to Run aka Full Power Level 2
  405.    - Losange Over-Excitation
  406.  
  407. Laurent Marsan (mbaye@univ-mlv.fr)
  408.  
  409.  o New Levels
  410.    - La Ruee Vers L'Or
  411.    - Survivor
  412.    - INV-X_IBLE
  413.    - Tic Tac Toe (without Short Fuse and Haunted Bombs)
  414.    - Je m'apelle Rico
  415.    - Toutencarton
  416.    - Born to be Killed
  417.  
  418. Mike Schneider (schneid@tellabs.com)
  419.  
  420.  o New Features:
  421.    - Short Fuse Bombs
  422.  
  423.  o New Levels:
  424.    - Suicide
  425.  
  426.  
  427. SPECIAL UNIX CONSULTANT
  428. Norbert Nicolay
  429.  
  430. "SENIOR" BETA TESTERS
  431. Rodi Herzberg
  432. Eckhard Grah (gone to Wuppertal :( )
  433. Norbert Nicolay
  434. Harald Tiesler
  435.  
  436. BETA TESTERS 
  437. Stefan Esser
  438. Andreas Fitzler 
  439. Joerg Gableske
  440. Rolf Kuehn
  441. Christian Meier
  442. Holger Meise
  443. Johannes Rest (gone to Munich :( )
  444. Hajo Richter
  445. Susanne Schell
  446.  
  447. BETA TESTERS (Australia)
  448.  
  449. Chris Doherty (CPD)
  450. Mark Black (Blackie)
  451.  
  452.  
  453. FURTHER THANX TO
  454.  o Cameron Gregory(cameron@cs.jcu.edu.au) for converting my README
  455.    into a manpage
  456.  o Henrik W. Nielsen(hwn@cci.dk) for his bugfix for the number-pad control.
  457.  o Jamie(be136@city.ac.uk) for his great idea of the extra, which
  458.    detonate ALL bombs (in the Halloween level) 
  459.  o Ian Jamison(ianj@melko.co.uk) for his bugfix of a timimg problem
  460.    with gettimeofday under Solaris 
  461.  
  462. THANX
  463. to all people, who send me an e-mail, that the programm runs on the their
  464. machine or just that they enjoyed the game.
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.